Skip to content

docs(maintainers): add style guide for input and output#422

Merged
zimeg merged 2 commits intomainfrom
zimeg-docs-maintainers-style-guide
Mar 20, 2026
Merged

docs(maintainers): add style guide for input and output#422
zimeg merged 2 commits intomainfrom
zimeg-docs-maintainers-style-guide

Conversation

@zimeg
Copy link
Member

@zimeg zimeg commented Mar 20, 2026

Changelog

N/A 📚 ✨

Summary

This PR adds a STYLE_GUIDE.md for common input and output patterns we're hoping to match- 🎨 📺

Notes

The current page is somewhat sparse but might be updated as confusion is found in ongoing change!

Requirements

@zimeg zimeg self-assigned this Mar 20, 2026
@zimeg zimeg added the code health M-T: Test improvements and anything that improves code health label Mar 20, 2026
@zimeg zimeg requested a review from a team as a code owner March 20, 2026 04:54
@zimeg zimeg added the semver:patch Use on pull requests to describe the release version increment label Mar 20, 2026
@codecov
Copy link

codecov bot commented Mar 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.71%. Comparing base (1065713) to head (2ea3f4d).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #422      +/-   ##
==========================================
- Coverage   69.72%   69.71%   -0.02%     
==========================================
  Files         220      220              
  Lines       18446    18446              
==========================================
- Hits        12862    12859       -3     
- Misses       4410     4411       +1     
- Partials     1174     1176       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Member

@mwbrooks mwbrooks left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Awesome start and just the right depth. There's no need to apologize about it being sparse because this PR is about creating the Style Guide and not writing it's content. If there was more content, we'd end up noodling over the details instead of merging it immediately 🚀

💅🏻 The Prompt Input is a great topic to start with since it's top-of-mind!

Comment on lines +192 to +195
## Style Guide

See [`.github/STYLE_GUIDE.md`](../.github/STYLE_GUIDE.md) for conventions on command inputs and outputs.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

praise: Awesome way to reference Claude into it.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mwbrooks Let's hope to reduce a turn or two with this 😉

👾 ramble: We did consider using the @../.github/STYLE_GUIDE.md syntax but didn't want to load this into context for unrelated tasks. It's an alright skill perhaps?

@zimeg
Copy link
Member Author

zimeg commented Mar 20, 2026

@mwbrooks Thanks for the confidence in this introduction 🐝 ✨

I'm both optimistic and excited for the direction things might be heading in so let's merge this quick to keep onward! 🍯

@zimeg zimeg enabled auto-merge (squash) March 20, 2026 21:01
@zimeg zimeg merged commit 12ca769 into main Mar 20, 2026
7 checks passed
@zimeg zimeg deleted the zimeg-docs-maintainers-style-guide branch March 20, 2026 21:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

code health M-T: Test improvements and anything that improves code health semver:patch Use on pull requests to describe the release version increment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants